﻿//////////////////////////////////////////////////////////////////////////////
//
//  Copyright © 1998-2024 Glodon Company Limited.  All rights reserved.
//
//  Use of this software is subject to the terms of the Glodon license
//  agreement provided at the time of installation or download, or which
//  otherwise accompanies this software in either electronic or hard copy form.  
//
//////////////////////////////////////////////////////////////////////////////


#pragma once


#include "GcmpRenderingInterface.h"


namespace gcmp
{
    /// \brief 文字显示管理器
    ///
    /// GCMP提供实现，不允许外部派生。
    FINAL_INTERFACE class GCMP_RENDERING_INTERFACE_EXPORT ITextDisplayManager
    {
    public:
        /// \brief 析构函数
        virtual ~ITextDisplayManager();

        /// \brief 获得文字显示管理器
        ///
        /// \return 文字显示管理器
        static ITextDisplayManager* Get();

    public:
        /// \brief 设置文字是否按照纹理模式离散
        ///
        /// \param isTextureMode 文字是否是纹理模式（默认是文字按照几何离散）
        /// \return true表示设置成功，否则设置失败
        virtual bool SetTextTextureRenderMode(bool isTextureMode) = 0;

        /// \brief 获得文字是否按照纹理模式渲染
        ///
        /// \return true文字按照纹理模式离散，否则按照几何离散
        virtual bool IsTextTextureRenderMode() const = 0;

        /// \brief 设置富文本文字是否通过字形进行拾取及矩形选择
        ///
        /// \param isPickByCharGlyph 文字是否通过字形拾取及框选（默认按照包围盒进行拾取及框选）
        /// \return true表示设置成功，否则设置失败
        virtual bool SetRichTextPickByCharGlyph(bool isPickByCharGlyph) = 0;

        /// \brief 富文本文字是否通过字形进行拾取及矩形选择
        ///
        /// \return true富文本按照字形拾取及框选，否则保持默认（通过包围盒进行）
        virtual bool IsRichTextPickByCharGlyph() const = 0;

        /// \brief 函数封装器，用于存储“富文本AcadString的回调函数”
        ///
        /// \param RichTextAcadString 富文本AcadString
        /// \return void
        typedef std::function<void(std::wstring& RichTextAcadString)> RichTextAcadStringCallBack;

        /// \brief 设置富文本AcadString的回调函数
        ///
        /// 该回调函数主要提供用户时机去处理富文本的AcadString,请注意各产品注意产品间链接协同情况一致性。
        /// 该回调函数主要用于IGraphicsRichText中，存储及用于显示的文本内容都以回调函数处理后的为主。
        /// \param callback 用户自定义的富文本AcadString的回调函数
        /// \return 设置成功返回true，失败返回false
        virtual bool SetRichTextAcadStringCallBack(RichTextAcadStringCallBack callback) = 0;
    };
}
